Versi 1
| Field | Isi |
|---|---|
| Dokumen ID | VBS-LAP-024 |
| Deskripsi | Laporan pesanan pembelian (PO) yang belum diproses penuh: sisa kuantitas dan nominal per PO beserta rincian barang |
| Nomor Revisi | 1 |
| Tanggal | 2026-10-04 |
| Keterangan | Dokumentasi baseline dari dokumentasi fitur demo dan kode FE |
1. Ringkasan
a. In scope
- User membuka laporan pesanan barang belum diproses dari daftar Laporan Pembelian.
- User memfilter periode, cabang, supplier, dan user.
- User melihat daftar PO beserta kuantitas masuk, batal, reorder, sisa, dan nominal sisa.
- User membuka rincian barang per PO.
- User membuka dokumen PO asal.
- User mengekspor laporan ke Excel sesuai hak akses.
b. Catatan
c. Kesimpulan
- [FE] -
- [BE] -
2. Functional Requirement
| Kode | Deskripsi |
|---|---|
| FR-01 | Halaman /brand/:id/pesanan-belumdiproses menampilkan PO yang masih memiliki sisa dalam periode terfilter |
| FR-02 | Sistem menampilkan kartu ringkas nominal sisa PO |
| FR-03 | User dapat melihat rincian barang per PO: kuantitas, masuk, batal, reorder, harga, diskon, subtotal |
| FR-04 | User dapat membuka dokumen PO dari nomor invoice |
| FR-05 | User dengan izin Excel dapat mengekspor ringkasan PO dan rincian barang |
3. Use Case List
| Kode | Deskripsi |
|---|---|
| UC-01 | Melihat pesanan barang belum diproses |
| UC-02 | Melihat rincian barang per PO |
| UC-03 | Mengekspor pesanan belum diproses ke Excel |
4. Use Case Scenario
UC-01 : Melihat pesanan barang belum diproses
| Aktor | User pembelian |
| Deskripsi | User melihat daftar PO yang belum diproses penuh dalam periode tertentu |
| Prekondisi | User memiliki izin #lap-pesanan-barang-belum-diproses |
| Alur utama | 1. User membuka Laporan Pembelian lalu kartu pesanan belum diproses. 2. User mengisi periode dan cabang; dapat menambah filter supplier dan user. 3. User menekan tombol tampilkan. 4. Sistem menampilkan PO: tanggal, nomor, cabang, supplier, kuantitas, masuk, batal, reorder, sisa, total nominal, dan sisa nominal. 5. Sistem menampilkan kartu Nominal Sisa PO. |
| Alur negatif | - Jika periode kosong, muncul alert "Periode Tidak Boleh Kosong". - Jika data kosong, muncul "Data yg anda filter tidak ditemukan silahkan ganti filter". |
| Bisnis rule | - Laporan membaca data PO yang masih memiliki sisa proses. - Nomor invoice mengarah ke halaman lihat purchase order. - Tombol kembali mengarah ke hub laporan pembelian. |
| Postkondisi | Daftar PO dan nominal sisa tampil |
| Trigger | User menekan tombol tampilkan |
| Kode FR | FR-01 FR-02 FR-04 |
UC-02 : Melihat rincian barang per PO
| Aktor | User pembelian |
| Deskripsi | User membuka baris barang di dalam setiap PO |
| Prekondisi | Daftar PO sudah tampil |
| Alur utama | 1. User mengaktifkan opsi lihat rincian barang. 2. Sistem menampilkan per PO: barang, kuantitas, masuk, batal, reorder, satuan, harga, diskon, subtotal. |
| Alur negatif | - Jika detail barang gagal dimuat, muncul pesan kesalahan mengambil data di server. |
| Bisnis rule | - Rincian dikelompokkan per header PO. - Nama supplier atau cabang kosong ditampilkan sebagai "Tidak Diisi" atau "Tidak Ditemukan". |
| Postkondisi | Rincian barang per PO tampil |
| Trigger | User mengaktifkan lihat rincian barang |
| Kode FR | FR-03 |
UC-03 : Mengekspor pesanan belum diproses ke Excel
| Aktor | User dengan izin Excel |
| Deskripsi | User mengunduh ringkasan dan rincian PO sebagai file Excel |
| Prekondisi | User memiliki izin #lap-pesanan-barang-belum-diproses aksi excel |
| Alur utama | 1. User menekan tombol export Excel. 2. Sistem menyusun dua lembar: ringkasan PO dan rincian pesanan. 3. Browser mengunduh "Daftar Pesanan Yang Belum Diproses.xlsx". |
| Alur negatif | - Jika periode kosong, muncul alert "Periode Tidak Boleh Kosong". - Jika data belum ada, muncul "Data tidak ditemukan". |
| Bisnis rule | - Ekspor dibuat di browser tanpa API export terpisah. |
| Postkondisi | File Excel terunduh |
| Trigger | User menekan tombol export Excel |
| Kode FR | FR-05 |
5. Data Flow Diagram
DFD-01 — Alur data pesanan belum diproses
6. Sequence Diagram
SD-01 — UC-01 : Melihat pesanan barang belum diproses
SD-02 — UC-02 : Melihat rincian barang per PO
SD-03 — UC-03 : Mengekspor pesanan belum diproses ke Excel
7. Table Schema
8. API Schema
| Endpoint | Status | Perubahan |
|---|---|---|
POST /laporan-pembelian/po-report | existing | - |
GET /invoice-purchase-order | existing | - |
GET /gudang | existing | - |
POST /supplier/get-supplier | existing | - |